home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 26 / Mac Magazin and MacEasy Magazine CD - Issue 26.iso / Online / ScreenViewCGI1.0b1 Folder / Read Me next >
Text File  |  1996-08-07  |  6KB  |  68 lines

  1. ScreenView CGI • 1.0b1 7-AUG-96
  2. by Joe Zobkiw
  3. © 1996 TripleSoft Inc. All Rights Reserved
  4.  
  5. Introduction
  6.  
  7. ScreenView CGI allows you to view your server's screen from any computer on the Internet.
  8. ScreenView CGI comes in two versions, 68k and PPC, and will run on any Macintosh running System 7.5 or later. Choose the version appropriate for your Macintosh.
  9. QuickTime 2.0 or later is required, the CGI will still launch but the screenshot will not be taken if QuickTime is not installed.
  10.  
  11. Ideas For Use
  12.  
  13. • Webmasters can use ScreenView CGI to monitor their server activity from afar.
  14. • Those of you with personal servers can use ScreenView CGI to show others how your server is set up.
  15. • ScreenView CGI can be used to troubleshoot server problems from a distance.
  16. • ScreenView CGI can be used to stream screenshots from one machine to another when called repeatedly.
  17. • ScreenView CGI can be used to maintain daily screenshot logs of server activity and server load by capturing status screens.
  18.  
  19. Instructions
  20.  
  21. Place the ScreenView CGI in your CGI directory (or anywhere else you would like it placed). You can trigger it with the following HTML:
  22.  
  23. <A HREF="http://www.yourdomain.com/cgi/ScreenViewCGI68k.acgi">Test ScreenView CGI 68k</A>
  24. <A HREF="http://www.yourdomain.com/cgi/ScreenViewCGIPPC.acgi">Test ScreenView CGI PPC</A>
  25.  
  26. After clicking on the link the CGI will be launched by your web server, take a screenshot, save it as a JPG file (named screen.jpg) in the same folder as itself, and return the URL of the JPG.
  27.  
  28. If you want to add password protection to this CGI (a good idea, otherwise everyone can potentially look at your server!) you should make use of the password and realms features of your web server.
  29.  
  30. ScreenView CGI can use a lot of memory...actually...QuickTime can. The 2MB partition that it ships with should work on most monitors at 8-bits using a Normal to High image quality setting (see below). If you run your server monitor at a higher bit-depth (or have a LARGE monitor) you may need to give the application more memory. If the CGI seems to be running but no image is produced, this is most-likely the problem. TripleSoft Inc. recommends you run your server monitor at no more than 8-bit color for best results.
  31.  
  32. ScreenView CGI creates JPEG pictures at the same bit-depth of the monitor. You can select the image quality from the Image Quality popup menu in the main control window. The higher the quality, the more memory the program requires.
  33.  
  34. The response type popup menu allows you to select how ScreenView CGI returns the picture to your server and ultimately your browser. Selecting Redirect uses the standard redirection method. Selecting IMG SRC returns the URL of the JPG file itself as part of a new page. Selected META Refresh is uses Netscape's refresh option to return the image. META Refresh is the best option if you are using Netscape as your browser. The others can sometimes confuse the browser because even though the JPG file itself has changed some browsers REFUSE to reload it…even after pressing theie reload button. Go figure. TripleSoft Inc. recommends using Netscape and setting this option to META Refresh. Try holding the option key while clicking the Reload button in Netscape to flush the cache for that page and reload the image no matter what.
  35.  
  36. The Automatically quit x seconds after handling an AppleEvent option in the main ScreenView CGI window allows you to set an auto-quit timer. When this checkbox is checked, after the CGI fully handles an AppleEvent from your server, it will begin to count down. If the specified time passes and no other AppleEvents are received, the CGI will quit. If another AppleEvent is received, the counter will reset. The default value is enabled with a 15 second timeout. It is our thought that this CGI will be used sparingly by system administrators who simply want to check the status of their machines every so often, therefore a 15 second timeout is probably adequate for most users. You can adjust this timeout to anything you wish or disable it altogether, in which case, the program will never quit unless you select Quit from the File menu.
  37.  
  38. Changes to preferences take effect the next time the CGI is launched. Therefore, you must manually quit the CGI after making changes to the preferences.
  39.  
  40. Clicking on the "moon around the earth" icon in the controls window will force the CGI to take a screenshot.  Using this, you can experiment with quality and memory settings without involving your server.
  41.  
  42. If you hear a "beep" during the picture taking process it means a problem occurred and a picture was not taken. This is most likely caused by lack of memory. Future versions may contain a log file option.
  43.  
  44. Version History
  45.  
  46. ScreenView 1.0b1 • 7-AUG-96
  47.    - Initial Public Release
  48.  
  49. Shareware
  50.  
  51. ScreenView CGI is $15 shareware. If you use it for more than 7 days please remit payment to TripleSoft Inc. All registered users will receive a free update to the final version 1.0 when it is released. Updates can always be found on the TripleSoft Inc. web site at <http://www.triplesoft.com/>
  52.  
  53. TripleSoft Inc.
  54. P.O. Box 30774
  55. Raleigh, NC 27622
  56.  
  57. (919) 872-0916 voice/fax
  58.  
  59. http://www.triplesoft.com/
  60. screenview@triplesoft.com
  61.  
  62. Bugs?
  63.  
  64. If you find what you think might be a bug please submit a bug report to screenview@triplesoft.com. Include the version of ScreenView CGI, the make and model of your Macintosh, the system version, server make and version, list of other programs (server and CGIs) running on the machine, list of system extensions and control panels, amount of memory in the Macintosh, and any other pertinent information you can think of. If we can reproduce it, we will do our best to fix it.
  65.  
  66. Legal
  67.  
  68. ScreenView CGI (the program) is provided AS-IS with no warranty expressed or implied. You use it entirely at your own risk. TripleSoft Inc., its officers and employees will not be held responsible for any damage caused directly or indirectly by this software. If you do not agree to this you should not execute the program on any computer(s).